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Editorial 


[ must start off by apologising for the delay in getting this issue out. At 
exactly the time the newsletter was due to be produced, I had to travel 
to the U.S. for an OS/2 developers conference on fairly short notice, and 
when I arrived back at the start of August, I had no free time left to work 
on anything other than OS/2. 


Happily, I finished my OS/2 driver at the start of the week, and so it is 
that you come to hold this issue of the newsletter in your hands. 


Console Wars 

A lot has been happening since the last newsletter in April. Commodore 
have finally launched their much-rumoured Amiga games console, in the 
form of the CD?? (see the article later on for more details). 


However, Atari have announced their own console system—the Jaguar. 
This looks like a very serious contender, boasting 24-bit graphics, 64-bit 
RISC technology, dual DSP's, and stunning realtime 3D effects, at a price 
below $200! Of course, it doesn't contain a CD drive, and it doesn't have 
the Amiga’s advantage of a long-established base of developers that are 
familiar with the hardware, but nonetheless, it should be interesting to see 
how it develops. Atari are expecting to ship by Christmas. 

The other big player is 3DO, which is really more of a specification than 
a single machine—this is similar to the role VHS plays in the video industry, 
for example. Its graphics capabilities are very powerful, and it includes chips 
that can manipulate video in realtime (a console videotoaster, perhaps?). 
Of course, it features a CD drive as standard. 

3DO has got a lot of big name backers, and the specification is very 
nice indeed, but it remains to be seen whether it can be delivered at a 
price point to make it successful—currently, machines are expected to cost 
around $600-$700, which is likely to put it out of reach of a lot of buyers. 
This should be on the shelves within the next 12 months or so. 


Nintendo, not wanting to be left out, have announced that they are 
teaming up with graphics experts Silicon Graphics to bring Silicon Graphics' 
technology to the household. However, they don't expect to have anything 
until mid-1995 (!) and who knows that the other companies will have come 
up with by then. 

In any case, CD?? is available right now, and as long as Commodore 
don’t mess up the marketing (who, Commodore?) it should be able to get 
a good foothold. 
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Fred Fish Moves to CD 

With the volume of Amiga public domain software continuing to grow, Fred 
Fish has taken the decision to move to CD for distribution of his library. 
He will continue to produce the floppy library up to disk 1000 (the magic 
figure) which will arrive sometime around Christmas '93; after that, you'll 
have to own a CD-ROM drive to access his collection. 


His first CD ships in October and is very reasonably priced at $20 plus 
an additional $5 shipping to Europe. He will be producing an update each 
month, and each update will contain between 50 and 150 Mb of new soft- 
ware. Older material will be deleted from the disc as required to make 
room. Initially, the spare space will be filled with the floppy fish collection, 
starting at the end and working backwards. 


Needless to say, CUGI has been put onto Fred's mailing list! More details 
as and when we get them. 


CUGI BBS, Mark II 

CUGI BBS has now switched to a new BBS package, DLG Professional, 
and is no longer suffering from the reliability problems it had when it was 
running under TransAmiga. It's available from 6 pm to 9 am weekdays and 
24 hours/day during the weekends. The number to call is 283 2829. 


Telecom Strikes Again 

Somewhat connected with the above note, I'm sure there can't be anyone 
who isn't aware of the controversial new charges that Telecom Eireann has 
introduced. It remains to be seen how this will affect the use of bulletin 
boards in Ireland; however, one effect we'll almost certainly see is that the 
use of offline reader programs will increase dramatically. 


Offline readers allow you to bundle all your new messages on a bulletin 
board and download them in one go, then peruse them offline at your leisure. 
If you reply to any of the messages, your replies can be uploaded the next 
time you call in. CUGI BBS supports the standard QWK format for offline 
readers, as do most other Irish bulletin boards. 


With any luck, one of our modem-literate members will be writing an 
article telling you more about this topic in a future issue. In the meantime, 
note that the majority of Dublin BBS's are now participating in a Telecom 
Boycott, and will not be answering the phone each Friday. 

That's about it for now. Don't forget to turn up for the AGM in October, 
since there will be a lot of significant changes taking place (you might even 
end up with a new editor, if I’m lucky!) Until then, enjoy this issue. 

E.C. 
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Dates for your Diary 
by Geoffrey Reeves 


he slight (!) delay in producing this newsletter allows me to give you 

a timely reminder of a few things. Firstly, there is the matter of 
membership—the cash bit! Don't forget to renew as soon as possible. Sec- 
ondly, the AGM will be held on Friday, 15 October in 5t. Andrew's College. 
The agenda will be published separately. 

With reference to that AGM, might I encourage those who cannot attend 
to use their proxy vote. By assigning your vote to a friend (or even someone 
you trust!) (ASSIGN VOTE: Friend), you can ensure that your silent voice 
can still be heard... well, something like that. 


Since half the current committee will not be standing again, the posts of 
Chairman, Secretary and Treasurer will all need to be filled. Including the 
other half of the current crew, at least ten people are interested in seeking 
a place on the committee. It would be most unethical to mention some (or 
even all) of these by name so you'll have to ask around. 


It would seem that seven members need to be elected so if you know of 
someone whom you feel would help in the running of the club, talk to them 
and so forth. As the great Vulcan was once dubbed: It always has been and 
always will be... your club (I think he's dead, Jim). 

In the meantime, we have some interesting items planned for future 
meetings. I’m sure the much-heralded CD?^ will be making an appearance 
at some stage, and Cygnus Ed 3.5 should be arriving shortly. 

In addition, we hope to get our hands on a Progressive Peripherals 
3o MHz 68040 accelerator (over twice as fast as an Amiga 4000/040), and 
also the Picasso II graphics card. For now though, here's a look at the 
provisional schedule for the next few months. 


Autumn Schedule 


J Sept First meeting after the summer break 
Apple CD-ROM 
17 Sept Last week of the old CUGI year 
1 Oct Have you paid your sub yet? 
15 Oct Annual General Meeting 
29 Oct What will the new committee think of? 


4 July 1993 


Video Backup System 


by Jamie Ruane 


(y of the hardware items available in CUGI's library is the Video 
Backup System. This, as its name suggests, allows the contents of 
your hard disk, or multiple floppy disks, to be backed up onto an ordinary 
domestic video tape! 


Hardware 

The hardware side of the package is quite small: simply a connector for the 
serial port of your Amiga, as well as a cable that goes from the Composite 
Video output of the Amiga to your VCR. Unfortunately, the A1200 and 
A4000 lack this output, and require an A520 modulator to work with the 
VBS. 


Software 

Also included with the package is a disk contining the VBS software. This 
can be installed on your hard disk, which I promptly did, using the included 
installer program. 


In Use 

The manual claims that a backup rate of 40 Mb per hour is to be expected, 
so I went to the local shop and bought two E-120 video tapes. The manual 
recommends that you use High Grade tapes, so I bought Fuji, a reputable 
brand. 

Then I wired up the family VCR to the back of the Amiga—or rather 
tried to. The supplied cables have phono connectors. The video I was 
using, of course, had BNC connectors. This meant that I had to obtain 
some BNC-to-Phono converters before I could use the VBS. Unfortunately, 
I could only find one such converter. The VBS, of course, needs two. I was 
able to do without one for the purposes of backing up and restoring, by 
simply switching the converter. 

When I finally got round to making a backup of my hard disk, I balanced 
the family VCR as near as possible to the Amiga and booted the VBS 
software. 

The software package supplied is menu-driven and quite easy to use. 
While not as sophisticated as Quarterback or AmiBack, it does its job 
quite well. However, it seems to take an inordinate amount of time to sort 
the directory tree, leading me to the conclusion that it had crashed when 


it hadn't. 
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Preparing to backup a partition to video tape! 


After perusing the manual, I set about making a backup. My first at- 
tempt ended in disaster, due to the video being tuned to the wrong channel. 
My second attempt succeeded, however, so about an hour after switching 
on the VCR, I had a backup of my DHI: partition on a video tape. 


| tested the restore facility using floppies; the system allows you to 
backup floppies whether they are in AmigaDOS format or not. The system 
didn't lose any of my data, but to be sure, I made two backups. 


Conclusion 
Overall, I'd say that the VBS is an easy way of backing up your hard disk, 
provided you have: 

o A suitable Amiga 

e Use of a VCR 


e A suitable video (some lack video-in and video-out ports) 
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Rocco’s Rumblings 
by Rocco Matassa 


dn editor has been pestering me lately. “Write something nice about 
the Amiga—surely that’s not too much to ask?” and I have to say that 
the Ed can be persuasive when he wants to. So here I am, 3 AM and not 
a single idea as to the content of this article. I know: I'll make a list of all 
the good and bad points. 


Good points 

The Amiga range use the Motorola range of microprocessors, namely the 
680x0 range. This is the preferred chip of the programmer; loads of registers, 
stacks of addressing modes and great flexibility. 


What does the PC have? Yes, the Intel 80x86 range, a design firmly 
locked in the past, archaic and inflexible. The small fact that there are 
more 80x86 programmers then all the rest put together is irrelevant. They 
have to put up with an inferior chip design, and are forced to develop 
programming tools not seen or heard of on the Amiga, to compensate for 
the shortcomings of their chip. 

Multitasking, the ability to hop from program to program, is unbeliev- 
ably useful. Routine tasks such as formatting disks, drawing diagrams in 
your favourite graphics package and pasting them into your article, all the 
time using a text editor of your choice and typesetter of your choice—these 
are things which are not really possible on a standard PC. Okay, I admit 
that all this can be done using a single program, such as Word for Windows, 
easier, faster, more flexibly and with better results in most cases; this only 
goes to show that PC programmers are aware of the problem and compen- 
sate with clever programming tricks, while we have proper multitasking. 


“Ah!” I hear you shout, “The programs on the PC take up lots of disk 
space; you never see such wasteful programming on the Amiga.” Well just 
about everybody and their uncle uses Stacker or some other disk compres- 
sion utility on the PC, and effectively halve the size of programs, or double 
their disk space. 

I've noticed a trend here; because of the dreadfully backward design of 
the PC, its archaic design, and its stone age philosophy, the sneaky program- 
mers have used ingenuity and wit to circumvent the machine's limitations. 
Perhaps if the Amiga hadn't been so perfect, Amiga programmers would 
have created really sophisticated products, such as Excel, Word, Coreldraw, 
etc. [Dream on!—Ed/ 

We still have the best entertainment software on our computer. After all, 
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since the demise of the Atari ST some years ago, software houses have been 
concentrating on the Amiga. Remember the bad old days when software was 
developed on the inferior ST. and then ported over to the Amiga, without 


even attempting to take advantage of the Amiga's superior specs? 


The fact that a few software houses, mainly American, develop exclu- 
sively on the PC, and then let a third party port over to the Amiga anything 
up to two years after the PC launch date, is nothing to worry about. After 
all, products like Wing Commander and Ultima Underworld are probably 
flash in the pan software, not likely to sell many copies. We can, knowing 
we have the world's best computer, ignore comments to the effect that the 
Amiga cannot cope with the requirements of these products. 


Another good point: there are almost 5 million Amigas sold. With that 
sort of base, surely no programmer worth his salt would ignore this potential 
market? Am I speaking the truth? Am I? 


Bad points 

Commodore. 

Commodore service. 
Commodore technical support. 
Commodore developer support. 
Commodore U.K. 

Commodore America. 
Commodore Germany. 


No Points 

Have I mentioned that I am currently using a PC? Well I must warn you 
about a program that comes with Windows called MineSweeper. I remem- 
ber this program from my C64 days, where I never gave it a second glance. 
However, I rediscovered it in the game directory in Windows, along with a 
very good version of Patience. Nice little touches in an operating system, 
I thought. 


Now if you're easily addicted to simple mindless computer games, avoid 
this like the plague. It wasn't too bad until I mentioned it to a friend who 
told me a colleague at work had being playing it for upwards of seven weeks 
and had failed to beat the expert level. I accepted the challenge, and in the 
space of two evenings, succeeded, while beating the times he had set at the 
two lower levels. You might think it would end there? No. I made another 
stupid mistake. 

I told another friend of my success, and in return, he quoted his times, 
somewhat better than mine at the time. Well, there started several weeks 
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of intensive play. Records were broken daily and sessions long into the wee 
hours were not uncommon. 


So, I warn you: stay away if you're the type swayed by the “just one 
more go, then I'll stop" argument, for it will lead you astray. Anyway, for 
now, 9-56-223; enough said. 


Compass Points? 

Oh yes, that was what I was supposed to do; write a positive article. Well 
for once, I found something that lives up to all the hype and advertising, and 
I can heartily recommend it to you: Gillette series Gel and Gillette series 
Aftershave really are good, and do live up to the advertising claims. Not 
bad, an honest ad for once! Not that I’m swayed by slick advertising... oh 
no, not me! 


Ah yes: Aerosmith's latest blast, Get a Grip, has reached No. 2 in the 
American metal charts; if you're into metal, check it out—it really is good. 
Ignore Dave Fanning. Better yet, send him a deaf aid and some taste. The 
video for Living on the Edge is real cool and the almost three year wait since 
Pump has definitely been worth it. [Several pages of Aerosmith ramblings 
deleted for the sake of the reader's sanity. —Ed| 


Solution To CUGI Crossword #8 


Solution to Aidan's crossword in the April 1995 Newsletter. 
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Amiga E 
by Colum Keane 


A re you unhappy with the selection of programming languages that are 
available for the Amiga? Are they slow compiling, or do they produce 
inefficient code? Then according to Wouter van Oortmerssen, Amiga E 


could be for you. 
Jack of All Trades? 


The author remarks how he designed Amiga E for his own use because he 
was unhappy with existing languages and that what was needed was a fast 
reliable compiler that could produce clean efficient code. Amiga E is the 
result of his efforts. It was designed taking features from languages such 
as C, Pascal, Modula-2, BASIC, ADA and even LISP. This it does well, 
taking good features from each without making it look like a pot-pourri of 
language fragments. Amiga E is a language of its own. 


Whilst the style of Amiga E may confound programmers more used to 
conventional languages, it could be an excellent choice for those new to 
Amiga programming. Amiga E has all the programming constructs that 
you would expect in a high level programming language. This includes 
IF-THEN-ELSE statements, FOR/WHILE/REPEAT loops and the often 
frowned upon GOTO statement. It also includes maths, comparison and 
logical operators. But Amiga E departs from the usual in its handling of 
variables—in the jargon, it is a polymorphic language. 


How to Avoid Typecasting 

There is only one basic type in Amiga E and this is a 32-bit long integer. 
So with no types as such, everything is a LONG or a 32-bit pointer to 
something. Arrays and structures are stored as pointers to the objects. 
There are many advantages to this type system—it removes the need for 
type checking for instance. There are also less worries about types passed 
to functions, no need for ‘casts’ as in C. This saves the compiler from having 
to typecheck, but this absence can hide bugs that would have been detected 
by a typechecking compiler. 

Another feature of Amiga E is the way in which it has simple commands 
to access Intuition functions directly without having to worry about com- 
plex structures, somewhat similar to the way in which AmigaBASIC handles 
such functions. It also has simple text and graphics functions built in. For 
those wishing to dabble in Amiga assembly language, Amiga E could prove 
to be a useful tool. Amiga E treats assembly language keywords as part of 
the language. This allows assembly to be freely mixed with Amiga E code. 
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The use of Amiga E variables and constants is also allowed. There are some 
restrictions to the use of assembly though—everything is case sensitive and 
not all addressing modes are allowed yet. Specific code for 020/030/040 is 
not yet supported though the author has plans for such support. 


The author has also built into Amiga E some data structures and some 
functions to manipulate them. Firstly there is the STRING structure which 
is similar to strings as found in other programming languages. As a string in 
Amiga E contains more information than just the sequence of characters, 
string manipulation functions are a little more flexible than those found 
in many other languages. The LIST structure is another datatype that is 
implemented in Amiga E. It often finds use when a system function expects 
a pointer to a structure. 


The Need for Speed 

The Amiga E compiler is very fast indeed. The author claims compila- 
tion speeds of 10,000 to 35,000 lines per minute for an unexpanded A500. 
Whilst I haven't had the opportunity to write such mammoth programs, 
compilation of programs of only a few hundred lines takes only seconds 
on an A500. It produces executables directly with no linking and assembly 
phases as found with other programming systems. Whilst this rules out link 
libraries and the use of pre-compiled modules, the compilation speed gives 
a very fast turnaround time when developing programs. The documenta- 
tion says that the compiler was written in assembly language for maximum 
efficiency. 


A plus for Amiga E is that the latest version (2.1b) has a complete set of 
2.04 include files rewritten for Amiga E and in a precompiled format (again 
for increased efficiency) and the author has promised a set of 3.0 includes 
by the next release. 


Diamond in the Rough? 

Amiga E is far from perfect though, and still has a few rough edges. For 
instance, floating point support is still lacking. As Amiga E is a new lan- 
guage, there are features that are under development and floating point is 
one such area. While floating point operations exist, the author says that 
the implementation will change and for compatability with future versions 
of the compiler, only system floating point operations should be used. 


The author acknowledges that documentation is not one of the package's 
strong points. In fairness to him though, volumes have been written to 
explain the detail of many other established languages, and Amiga E does 
not have this background. The compiler manual offers good coverage to the 


many features that the language has, but it does not explain the basics of 
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Jx TurboShell in Amiga E. note that we use our own CON: x/ 
E 


PROC main() 
DEF inputstring[80] :STRING, con 
IF con :7 Open('con:10/10/400/100/TurboShell v0.1', NEWFILE) 


Write(con, ’Shell by Fred. Type "BYE" to stop.\n’, STRLEN) 
WHILE StrCmp(inputstring, 'BYE', ALL) = FALSE 
Execute(inputstring, 0, con) 
Write(con, ’Turbo> ’, STRLEN) 
ReadStr(con, inputstring) 
UpperStr(inputstring) 
ENDWHILE 
Close(con) 
ENDIF 
ENDPROC 


A simple Shell program written in Amiga E 


programming. Those familiar with other languages should have no problem 
in picking up the language, but for those new to programming, perhaps a 
crash course in BASIC could be a help. When it comes to ironing out subtle 
bugs the manual offers little help. Passing pointers to system functions in a 
typeless language for instance, can often lead to gurus and good guesswork 
is often the only course of action. 


Conclusion 

All considered, there is not a whole lot wrong with Amiga E. It is mostly 
little things that could cause problems and perhaps you would expect this 
from a new programming language anyway. It could be a matter of pro- 
gramming style for instance—the fact that all keywords are in capital letters 
might be awkward for some. 


Ihe development of Amiga E is not yet over. The author is still at 
work adding features which include object orientated programming, better 
floating point support, support for modular programming, and maybe a 
source level debugger. There is also a network of supporters on the Internet, 
with Amiga E having its own mailing list, providing useful hints and tips 


and distributing sample code. You can expect to hear more about Amiga 
E in the future., 


The Amiga E distribution archive which includes docs, sample code and 
j "oBramming tools is available from the fish library, and can also be down- 
oaded from CUGI BBS or Infomatique. 
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GadToolsBox V2.0 
by Karl Jeacle 


prm is a ‘giftware’ program written by Jan van den Baard which 
lets you draw/edit GadTools gadgets and menus and then generates the 
corresponding source code for you. The latest version is 2.0 and is on Fish 
Disk 842. It is also available on Infomatique BBS. I must point out that 
this is by no means a comprehensive review of the program—it is merely 
an account of one user's experience with it. 


So what does it do? 

After coming home from work/college/school or whatever you do during 
the day, you don't always have the time to launch into writing code for the 
Amiga. Time is always at a premium. Playing a few games, logging onto 
a BBS or just hacking around in general always seems a lot easier than 
writing code. This is certainly my experience anyway. 

I came across GadToolsBox recently while going through some of the 
Fish Disks. I installed the program and decided to give it a try. Usually, 
I skip over a lot of the programming tools I come across as I figure | just 
don't have time for them; however, I decided to try out Gad ToolsBox. 


Not having programmed the Amiga for some time, my Amiga C was 
a bit rusty. As a result, I was curious to find out just how easy it was 
to generate a front-end for whatever killer application I could now write. 
Without looking at the documentation, I created a couple of windows on 
a custom screen, set up various attributes for each window, and selected 
Generate C Source. A C source file and header file were promptly created. 


Having had a quick look at the source which was generated, 1 typed in 
the following: 


main() 

1 
SetupScreen(); 
OpenWindow1() ; 
OpenWindow2() ; 


Delay (500) ; 


CloseWindow2() ; 
CloseWindowi(); 
CloseDownScreen(); 


} 
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I ran this code through DICE along with the Gad ToolsBox code, expecting 
a few million compilation or link errors. To my surprise, an executable was 
created without any problems! And sure enough, when I ran it, up came 
the screen with two windows, and after a short delay, they were gone again. 
It was no big deal, but I was impressed. 1 decided this program was worth 


a more serious look. 


You pays yer money... 

GadToolsBox is ‘giftware’ which means that if you like the program you 
should reward the author with a gift that you think matches his efforts. 
This can be any gift you like, not just money. 

Since GadToolsBox is all about gadtools.library and this comes with 
Workbench 2.0, you must have at least this revision of the Amiga OS to 
use the program. It also needs a few other libraries such as the freely 
distributable reqtools and powerpacker libraries. 


The documentation supplied is pretty good. A 3000 line AmigaGuide file 
is provided with plenty of links and sample source to help you do most things 
you'll want. The complete source code to the program is also provided. 
And naturally, most of the requesters the program uses were generated by 
Gad ToolsBox itself. 


GadToolsBox not only allows C source to be generated, but it can also 
produce Assembler and Oberon! code. And not only does it produce the 
basic GUI code, but it can now also create ‘IDCMP handler’ code—more 
on this later. 


The only competitor to Gad ToolsBox that I know of is Commodore's 
ToolMaker which was demonstrated at CUGI recently. This is a commerical 
product and costs about US$75. 


Down to business 

The whole point of GadToolsBox is to take the pain out of creating GUI 
code. While it's all very interesting figuring out how it all works, and taking 
great pride in handcrafting an interface, writing GUI code can be rather 
tedious, and at times, quite boring. The other consideration, as mentioned 
earlier, is time. Creating a GUI can be quite a time intensive task; a 
complete edit-compile-run cycle is required just to check if those windows 
line up or that gadget is in just the right place. 


With GadToolsBox, you can create screens, windows, menus, and every 
type of GadTools gadget available. You can do this interactively. You can 


l Yet another Niklaus Wirth creation—he of Pascal and Modula-2 fame. 
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Gad ToolsBoz in action 


move windows and gadgets around on the screen to your heart's content 
until they meet your approval. You can test how your menus look, and how 
they operate. You really can create your whole GUI with this program and 
then just have all the source code generated in the language of your choice. 


But Gad ToolsBox doesn’t stop here. Not only can it generate the code 
to create and display your GUI, but it can also create ‘handler’ code and 
provide you with stub functions where you can fill out the code which should 
be executed when a certain menu item is selected or a gadget clicked. 


For example, the screenshot above shows the menu creation window. 
Here you can define everything about your menus: item names, keyboard 
shortcuts, whether the option should be initially disabled/ghosted, whether 
or not this menu item should have checkmarks, and what other items are 
mutually exclusive to that selection. But what you can also do here, is 
give the name of the function which should be called when this menu item 
is selected. In the figure shown, selecting ‘9600’ would cause a function 
named Receive9600() to be called—‘Receive’ being the name of the window 
to which the menus are attached. 


To make use of this facility, your mainline code should make a call to a 
‘handler’ routine called (in this case) HandleReceiveIDCMP(). This func- 
tion acts as a dispatch function; it checks what message has been sent by 
Intuition, and calls the appropriate function. A global copy of the Intui- 
Message which caused the function to be called is available to you when 


inside your function code. 
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One thing you do have to remember with Gad ToolsBox is that you should 
never attempt to modify or tweak the code that it has created. This is 
because if you intend to generate that code again, any changes that you 
have made will be overwritten when the new source is output. 


Criticisms 
If I have any criticism to make of GadToolsBox, it would be that both 
it, and the source it creates, are a little bit buggy in places. I have come 
across at least one bug while using the program and have read on UseNet of 
various scenarios where incorrect code has been created. Another point is 
that the code it creates is a little lacking on the side of comments—variable ` 
names are a little obscure at times, and it’s not always clear exactly what’s 
going on. 

Having said this, of course, you have to bear in mind that this code 
was never really intended for human consumption; it’s supposed to be run 
through a compiler without the user ever looking at it. 


Conclusion 
GadToolsBox should not only be of interest to those who want to create a 


complete GUI with minimum hassle, but also to those who are interested 
in learning more about programming gadtools.library. Simply seeing how 
it’s done by looking at the generated source can be extremely useful! 


The bulk of GadToolsBox users, however, are probably those who are 
going to use the code it produces as a basis for their own GUI code. They 
can take the output and modify and enhance it to suit their own needs. 


For me, GadToolBox was something that got me back into programming 
the Amiga. At first I thought it could do just about everything, but now 
I can see the limitations involved in using it. What you gain in ease of 
use, you lose in flexibility. There are several things I'd like to do with 
GadToolsBox now, but can't, and because of this, I’m tempted to move 
into that last category of users who take its output and hack on it. This 
is unfortunate, as one of the nicest aspects of using Gad ToolsBox is being 
able to flick screens, revamp your GUI, flick back, and do another ‘make’ 
to have a brand new GUI on your program. 

In conclusion, I'd say that Gad ToolsBox is a pretty darn handy program 
to have around, and if you've ever played about with C on the Amiga, but 
never quite managed to to get to grips with programming the GUI, then 
it’s well worth taking a serious look at. 


16 July 1993 


The Amiga CD 
by Eddy Carroll 


y now, you will all have heard about Commodore's latest: Amiga, the 

CD?*. As usual, Commodore decided to wait until I was running late 
with the newsletter to launch the system—if I was paranoid, I'd think they 
did it on purpose just to fluster me! 


In any case, the official launch took place in London on 16 July (my 
birthday!) and featured TV personalities Chris Evans (sporting a loaded 
water pistol) and Bruno Brookes, along with Commodore director Mehdi 
Ali and other Commodore personnel. 


By all accounts, the launch went very well. Particularly notable was 
the full motion video (FMV) add-on cartridge, which was demonstrated 
in all its glory. Since Commodore have occasionally been somewhat over- 
optimistic about the availability of add-on products, it's nice to see that 
FMV isn't just an idle boast. Quite a few of the non-Amiga magazines and 
newspapers have since carried positive stories about the CD**. It’s also 
made an appearance on several UK television programs. 


There was also a recent Irish launch held by EmCee distributors, which 
led to positive coverage in several Irish newspapers, including The Sunday 
Business Post, The Sunday Independent, and The Sunday World. What's 
all this? Commodore finally getting their marketing together? Well, only 
time will tell, but it looks like a good start. 


In case any of you have somehow missed all the publicity, here's a brief 
description of the unit itself. The CD?* is essentially a dedicated games 
console, based around Amiga 1200 technology, but with a built-in double- 
speed multi-session CD-ROM drive. Unlike the A1200, it lacks a keyboard 
and floppy drive, along with most of the i/o ports. In fact, the only form of 
input is via an 11-button keypad controller. It has stereo audio, of course, 
along with a headphone socket and volume control. On the video side, TV, 
composite and SVHS signals are available, but disappointingly no RGB. 


The final two interfaces on the system are a general purpose high-speed 
auxilary port (designed for keyboards, data gloves and other such devices) 
and an expansion port. The expansion port provides access to all the main 
Amiga signals, which means that it will be possible to expand the CD?* into 
a full Amiga at some point in the future. At least one developer is currently 
working on a cartridge to add a full serial port via the expansion port, which 
would open up the possibility of linking the CD?? to another Amiga using 
something like SerNet. In conjunction with a suitably prepared CD that 
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Commodore’s latest Amiga: destined for the big time? 


had the appropriate boot software and drivers, this would provide limited 
CD-ROM access to your main Amiga (very handy for PD discs and the 
like). 

I saw a demonstration of a prototype back at the Orlando developers 
conference, and I can report that the quality 1s excellent for a consumer level 
product—somewhere above VHS, but without all the stability problems 
normally associated with videotape. The way it interfaces with the Amiga 
video is quite clever; it appears as a genlocked video source. This means 
that Amiga graphics can be overlaid onto video footage, making it easy for 
games to use video to enhance the action. 


The final item of note is a new chip called Akiko (formerly Arizona). 
This handles a lot of the dogwork in the CD32, including controlling the 
CD player itself, but in particular, it can convert pixels from planar format 
to chunky format. This is significant, because a lot of 3D games that use 
texture mapping can operate much more efficiently with chunky pixels than 
with bitplanes, and it should make it much easier to write such games. 


Commodore claim that a CD?? compatible CD-ROM upgrade for the 
A1200 will be available by Christmas '93. This will incorporate the Akiko 
chip, making the A1200 fully compatible with all CD?* games. 


And speaking of games. .. there will apparently be about 30 games avail- 
able in the first month or two. Developers have had machines for the past 
six months, and many have been concentrating on CD?? rather than A1200 
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titles—this explains the fairly tiny number of AGA-specific games that have 


surfaced so far. 


Overall, the CD?? could be just the shot in the arm that Commodore 
needs to get back on its feet. At a RRP of £299 in the UK (already being 
discounted), and an estimated £149-£199 for the FMV catridge, it should 
sell very well—I'm thinking of getting one myself, in fact. 

To finish off with, here's a list of titles that are currently available or in 


development: 


Company 
Acclaim 
Bullfrog 
Centaur 
Flairsoft 
Grandslam 
Gremlin 


Hex 
Krisalis 
Maxi 


Microprose 


Millennium 
Mindscape 
Mirage 
Ocean 


Plattsoft 
Psygnosis 


Sachs Entertainment 


Team 17 
Thalion 
Titus 


21st Century 


Virgin 
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Games 
Mortal Combat 
Biosphere, Syndicate, 


Fantastic Voyage 

1869, Oscar, Whale’s Voyage 

Nick Faldo’s Golf 

Hero’s Quest, Litil Divil, Nigel Mansell, 
Premier Manager, Zool, Zool 2, Utopia 2 
Global Chaos 

Sabre Team, Soccer Kid, Manchester Utd 2 
Sim City 

Civilisation, Gunship 2000, Legacy, 

B-17 Flying Fortress 

James Pond 2, Diggers, Daughters Of Serpent 
Alfred Chicken, Liberation, Compilation disk 
Rise Of The Robots 


Inferno, International Golf, Jurassic Park, 
Sleepwalker, TFX 


Amiga CD Football 

Microcosm, Renegade, Sensible Soccer, Uridium 2, 
Chaos Engine 

Defender Of The Crown II 

Alien Breed 2, Body Blows, Project X, Super Frog 
Lionheart 

Battlestorm, Prehistoric 

Pinball Fantasies, Pinball Illusions 

Dune, Musicolor, North Polar Expedition 
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Backing Up, the Hanoi Way 
by Aidan Hollinshead 


hen it comes to backups, most people see it as a chore—something 

which they could very well live without, except that they're a little 
worried that if they do try and live without it, then fate, having been so 
mocked, shall wreak revenge. Admittedly, the waiting until the horse has 
bolted to shut the stable door philosophy is still quite prevalant and I can 
think of several people who have more or less given up, if indeed they ever 
started. 

I suppose this isn't terribly surprising when you consider the fact that 
many people now have hard drive capacities running into three figures. 
When it comes to backing up to floppy disks, that comes to an awful lot of 
floppies, not to mention the time involved switching the various disks. 


There are of course alternatives. The standard solution is a tape backup 
device, whether it be a dedicated backup tape drive or perhaps even onto 
video tape, although I have also heard of people backing up volatile stuff 
onto a separate hard drive (it's well for some to have a spare one) and the 
replaceable data once onto floppies. 


It Sounds Easy, But... 

Suppose that you are doing backups and you keep several backups at a time 
(a very common practice in business where backups are often made once a 
day). Now comes a problem. 


Suppose you have a backup tape drive; these are only a few hundred 
pounds these days, and for a large hard drive are really the only practical 
option for frequent backup. We'll also assume that you have ten tapes on 
which you store backups of varying ages. The question is: how do you know 
which tape to use next so that, in the case of something going wrong, you 
can quickly restore your data, whether the corruption happened a matter 
of minutes earlier, or perhaps weeks or even months earlier? 

This whole subject is something which, for several reasons, I have been 
considering of late. Whilst I don't maintain that what I put forward will 
be the best, quickest or easiest to maintain methods, it will describe some 
that meet each of the criteria. 


Backups Galore 

Ideally we want a system where it is easy to know where we are to backup 
to next, and one which allows us to have a backup as close to the date of 
Initial data loss as possible. 
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The first and easiest method which is often practised is to simply progress 
though the backups in a cyclic fashion. Suppose every time you do a backup, 
you progress from one tape to the next; you start with tape one, then tape 
two, etc. until you reach tape ten and then move back to tape one again. 
This means that you will always have the last ten backups you did. 


This is a very easy system to operate in that you need only remember 
which tape you used last time, to know which to use this time. It also has the 
advantage that it allows you to quickly restore yourself to normality, if the 
problem occurred in the period covered by your last ten backups. However, 
if the problem has been around for a long period of time and perhaps was 
only recently detected on some rarely-used data, then you may not be able 
to recover it, which is a fairly serious flaw. Say for example, someone goes 
on holidays for two weeks, and his files are lost the day after he goes; by 
the time he gets back and realises the problem, it is too late. 

So, perhaps it's not the best system, since if a problem goes unnoticed 
or unreported for as short a time as a fortnight, assuming one backup a day 
(admittedly fairly ambitious for home users), then the data is effectively 
written off. 

What we really need is a backup regime which staggers the frequency of 
the backups so that the most recent backups have only a short period of 
time between them, but as we consider the older backups, the gaps between 
backups stored increases. 

One fairly popular solution is to use the natural divisions of weeks and 
months. The tapes are divided into three categories: daily, weekly and 
monthly. Four daily tapes are used to hold backups from Monday to Thurs- 
day; every Monday, the backup from the previous Monday is overwritten 
and ditto for Tuesday to Thursday. 

The weekly backup tapes are always used on Friday and there are three 
of them. On the first three Fridays of the month, you use these tapes in 
order and then on the final Friday you use a monthly tape. These monthly 
tapes are only used on the final Friday of each month and the three of them 
store the backups for the last Fridays of each of the last three months. 


Thus, you have four tapes less than a week old, another three less than a 
month old and another three less than four months old, and so cover three 
months fairly effectively with only ten tapes, instead of the 90 or so that 
would be needed with the simple cyclic system. 

This has the advantage that it fits in nicely with the regular human 
existence and whilst there will be some wastage in that the same job could 
be done with fewer tapes, it is a nice easy system to learn and understand 


July 1993 21 


and does leave you with backups of various ages. 


We may ideally want to have one backup that is 1 day old, another that 
is 2 days old, another that's 4 days old, another that's 8 days old, etc. or 
as close as possible, so that we have a sort of exponential coverage of the 
period. The problem then presents itself as to how to go about doing it. 


The answer, perhaps surprisingly, turns out to be equivalent to the an- 
cient puzzle of the Towers of Hanoi, which consists of three poles and sixty- 
four rings of various sizes. The rings were originally laid out all on one pole, 
sorted with the largest ring at the base and the smallest ring on top. The 
object is to move the whole pile to another pole by moving one ring at à 
time, never putting a larger one on top of a smaller one, until they are all 
on the other pole. The rings are moved constantly and according to legend 
the world will end when all the rings are moved. Given that at the rate of 
one a second it would take over six hundred and fourteen thousand million 


years, we're safe for a while yet. 


That's all very well, you may say, but what has it got to do with backing 
up our hard disk drive? Well, it turns out that if each ring is viewed as a 
particular tape, then the ideal order of which tape to use next is the same 
as which ring needs to be moved next. You may be thinking by now that to 
follow this method of backing up, you are going to need three poles and ten 
rings but that isn't necessarily the case (although it would provide some 
entertainment, I suppose). 


Without the poles and only noting down when each tape was last used for 
a backup, it's still possible to use this method. A simple way of determining 
which tape needs to be used next is to number the tapes from one to ten. 
When you go to make a backup, consider tape number one first. Check 
when it was last used. Then, if a tape with a higher number has been used 
since then, you're to use tape one, otherwise repeat the procedure with tape 
2 and so on until you find the tape you need to use next. 


By doing this you should end up with the following pattern which cor- 
responds to the movement of five rings from one pole to another. 


1213121412131215121312141213121 
i IT dd XLdluL | 


s x. c ae —..2 4 4 a 
3 3 3 3 
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This shows that in fact it's just a complete binary tree with the number 
corresponding to the level. 

Naturally this can be extended with 10 tapes which will allow for 2!° 
backups; at the rate of one a day, this would last almost three years. The 
really good thing is that you will always have backups from the previous 
two days as well as others which are fairly equally distributed across the 
full range. There will always be least one backup between 2” and 2^*? days 
ago. 

Perhaps some of you heard of the Towers of Hanoi and thought that it 
had no practical application. (Don't tell that to the priests in the Temple 
of Benares!) If nothing else, maybe this article has reminded you that it's 
been too long since your last backup. 


Classified Ads 


Commodore 64 with tapedeck, mouse, joystick, magazines, extra man- 
uals, and £300+ of games and other software. Ideal first computer. One 
careful owner. MUST SELL. £110. 


Amiga Rochard hard drive controller. Suit A500/500+. Never used! 
Can fit IDE/SCSI 3.5" drive and 8 Mb internally, and up to 7 SCSI drives 
externally with optional cable. Worth £170 new. MUST SELL. £110 o.n.o. 


42 meg IDE hard drive. Seagate ST157A 3.5" half-height (not low-profile). 
Suit most IBM PC’s and Amiga 4000. MUST SELL. £75, or swap for 
modem. 

Second-hand packet radio setup for use with Amiga computer. Any 
offer considered. 


Wanted: Amiga 1200 contacts to swap PD and industry news. Modem 
users preferable. No pirates! Also, I'd like to hear from any other Amiga 


modem users in the Midlands area. 


(For all the above items, contact Damien McKenna on 0902-36124.) 


2.0 RKM Libraries, good condition: £20. 1.3 RKM Libraries & Devices: 
£5. Phone Karl on 677 5365 (evenings). 


Wanted: 2.0 Rom Kernel Manuals (3rd Edition). Single volumes or 
complete set considered. Phone Tommy on 289 1598 (evenings). 
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CUGI Crossword #9 
by Aidan Hollinshead 


amu 
ROSRESNSE 


d eo 
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Across 


1. Smaller cats than Jaguars to cover the floor (7) 
6. The notice chooses to bring up another's child (6) 
T. Standards for military clothes (8) 
8. Noah’s favourite fruits (5) 

9. How a cockney gets a lift (7) 

14. Take care of mixed up runes (5) 

15. Puzzling about scattered spore (5) 

16. Coddles then turns around and gave out (7) 

17. It rises to the top (5) 

20. Changing the sound of a bell after agreement in church (20) 
22. The insect and little Theodore played cricket (6) 

23. Loudest empty things (7) 


Down 


1. Warned about a mixed up education (9) 

2. Does Ireland initially have a French king (3) 

3. The eastern reason may cause laughter or tears (7) 

4. A backward person assistant initially lauded the valuation (7) 
5. Sounds like rowin’ on the mountain (3) 

6. What sap killed Cleopatra (3) 

10. A poor trace is part of a large company (9) 

11. Disgusting number (5) 

12. Gramp said something confused about an example (9) 
13. Spin a top turning assigns someone (8) 

18. Dam up the crazy (3) 

19. The exit of the tide is found in the pebble (3) 


21. Hard HIJKLMNO (3) 
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Exploring CShell 
by Tommy Gibbons 


he information that you are about to read was picked up by myself 
mainly as a hit and miss affair on a Workbench 2.05 Amiga. Any 
damage that you might do is entirely at your own discretion. 


I have an intense loathing for reading intensely boring tomes about how 
the higher end of the computer world do things. For example: 


alias scifi "4j foreach file ( $j ) V'set ul _;getsub $file; \ 
set name SF. $vol$ul$issue; Tail +$line «$file Ww 
>ram:t/$name; cp ram:t/$name ul:;\"" 


I decided to at least try to understand what was going on. Honestly, I still 
do not know what language the above example was written in! However, I 
endeavoured to try aliases with Csh 5.19. 

I created a file in S: called login.sh (Csh automatically seeks a file 
called S: .1ogin but I would rather have control of things); this file is used 
to set up aliases and define function keys. You can ensure that this file is 
read every time that a NewShell or a new CLI is called by placing the line: 


csh -r s:login.sh 


in the file S:Shell-Startup. The -r option is to make Csh resident. The 
-i0 option disables the AmigaDos internal commands. 


Starting Off : 

Let's look at an example of a .login file. Note that.the # symbol is 
similar to the REM statement in BASIC and indicates to the computer to 
ignore anything else on the line. 


set  .prompt “O° [[33m4p» ^ [ [Om 
set _titlebar " Shell Process %n Date fd " 


It starts off by setting the prompt, so we can see at a glance which directory 
we're currently in. All those strange characters basically Just arrange for 
the prompt to be printed in orange (colour 3) to make it stand out from 
the commands you type. 


The -titlebar setting defines what appears in the shell window's title- 
bar. The code %n indicates which shell window is which (useful information 
if you are passing data between shells) and the %d gives the date. Other 
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useful codes are fm to give the amount 


of free memory and %f to give the 
amount of free disk space. Finally, y B 


set history 50 


limits the number of previous commands that the shell process will remem- 
ber. Each process's history is unique. 


The function keys may be set to perform a list of commands. If there are 
spaces included it is advisable to enclose the list in quotes (" "). Adding 
^M causes an automatic return, so that the command is executed as soon as 


you press the key. Using f1 or Fi denotes the unshifted or shifted function 
key respectively. 


Set function keys 


+ H 3$ 


set f1 "u0; ged s:startup-sequence; 10"^M 
set 12 "u0; ged s:firstlogin.sh; 10"^M 
set £3 "u0; ged s:login.sh; 10"^M 

set f4 "u0; ged s:assign script; 10"°M 
set £5 "u0; ged s:user-startup; l10""M 


These keys are used to unlock hard disk partition dhO: (via the alias u0) 
and load s:startup-sequence into the text editor Qed for editing. When 


the editing is complete, 10 locks the drive again. The '; separates one 
command from another. 


set £7 dir =s “N 

set F8 "run sys:diskops/quarterback""M 
set FQ "run sys:printer/labelprint" M 
set F10 initprinter"M 


These commands are just convenient shortcuts to get a directory listing or 
start various programs running 


Aliases | 
Aliases are used to save time typing and are a must for anyone using any 
kind of shell. They may be used to shorten simple commands like below 
or to save time typing in a command line like the initial example above. 
You can pass parameters to aliases using the not 
text, and then refer to the parameters using $i 
an example of this). | "3 
Here's a collection of aliases I use to give you the 1dea: 


ation 4i at the start of the 
(see the alias for spell for 
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i 


# System aliases 

i 

alias 10 "lock dh0: on" 

alias 11 "lock dhi: on" 

alias uO "lock dh0: off" 

alias ul "lock dhi: off" 

alias ed "run ged" 

alias nshell "newshell" 

alias qfmt "format drive dfi: name TG noicons quick" 
alias remrad "remrad force" # Stops booting from RAD: 
i 

i Aliases to start programs 

# 

alias amos "source sys:s/amos-startup" 

alias dice "newshell from s:dice-startup" 
alias paint "Source sys:s/dpaint-startup" 
alias pdc "Source sys:s/pdc.login" 

alias publish "source sys:s/pagesetter-startup" 
alias sb "Source sys:s/superbase-startup" 
alias sd "run sys:diskops/SuperDuper" 
alias sdos "sys:bin/snoopdos -zsys:fool" 
alias sdosq "sys:bin/snoopdos -q" 

alias spell "hi; u0; azspell i; azmerge; 10" 
alias video "source sys:s/dvmaker-startup" 


These are aliases used to call script files in different partitions of the hard 
drive. The script files in turn are used to carry out a series of operations 
including locking/unlocking drives, mounting devices, changing directories, 
and so on—just about anything that is legal. 

For example, the spell alias expects the user to type e.g. spell xyz. 
As mentioned above, the 4i at the start of the command string is used 
to match this parameter. Next, the hard drive partition is unlocked using 
u0. The AZSpell command is run, automatically opening the file xyz; this 
is achieved by using $i. The AZMerge command is used to update the 
dictionary. And finally, the 10 alias locks the hard drive again. 

This information is aimed basically at the first time user, and people 
like myself who just dabble about mostly (and sometimes dribble). If you 
are trying out any of this, make sure that you have ALL your hard drive 
backed up for the time when things DO go wrong. 
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CUGI Library 
by Magnus Byne 


he CUGI library has a large selection of Amiga books, including a range 

of Abacus books covering most aspects of the Amiga, and Commodore's 
Rom Kernel Manuals (essential if you are doing programming). In addi- 
tion, there are reference books for the C64 and C128, along with general 
programming and computer books. 


You can borrow books from the CUGI library at any meeting, free of 
charge. You must return them by the following meeting, but if nobody else 
wishes to borrow them, you can renew them for another two weeks. 


Here's a list of what's currently available (new titles may have been 
added by the time you read this): 


Abacus 
AmigaDos Inside and Out 


Amiga for Beginners 

Amiga Disk Drives Inside and Out 
Amiga Guide for Advanced Programmers 
Amiga Internals 

Amiga Tricks and Tips 

Desktop Video Guide 


Commodore Reference Manuals 
Amiga ROM Kernel, Libraries 2.0 


Amiga ROM Kernel, Devices 2.0 
Amiga ROM Kernel, Includes and Autodocs 2.0 
Amiga ROM Kernel, Style Guide 


Amiga ROM Kernel, Libaries and devices 1.3 
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Hardware 
The CUGI library also has the following hardware available for loan: 


Audio Sampler 

Video Backup System 
Modem (2400 baud) 
Video Digitizer 
Handheld Scanner 


You need to be a member of the club for at least six months before you are 
entitled to borrow any hardware items. For the Audio Sampler and Video 
Backup System, there is a rental charge of £2 and a £3 deposit. For the 
other items, there is a rental charge of £3 and a £7 deposit. 


For more information contact me at any club meeting. 


Monitor Musings 
by Colin Dalton 


[: you have one of the AGA-equipped Amigas, you are probably aware 
that the computer is capable of supporting new, high-resolution screen 
modes. Actually using these modes is a different thing altogether. 


First, you have to have a monitor that will physically connect to your 
Amiga. Most higher-end monitors have 9-way or 15-way plugs, no good 
for the Amiga's 23-way connector. To get around this, Commodore (and 
others) have come up with the Productivity Adapter, a small adapter which 
plugs into your video port and gives you a 15-way output. 


Now that you can actually connect the monitor to your computer, you 
have to be sure that it supports the Amiga's output frequencies. There 
are two values you need to know: the horizontal frequency and the vertical 
frequency. The vertical frequency is the number of times the screen is 
redrawn per second; this is 90 Hz for PAL, and 60 Hz for NTSC. Low- 
end VGA monitors will be fixed to a 60 Hz output, but better ones will 
automatically sync from 50 Hz to as high as 87 Hz. 


The horizontal frequency is the one that causes the most problems for 
monitors. A standard PAL output has a horizontal frequency of 15.625 kHz; 
that is, it outputs 15,625 lines per second. A low end VGA monitor will 
be fixed at 31.4 kHz, so you wont be able to display a PAL screen prop- 
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erly. Since this is the default, it can cause problems. Luckily, Commodore 
supplies a driver for VGA monitors, called (rather confusingly) Multiscan. 


To use it, you drag the Multiscan and VGAOnly icons from your Stor- 
age/Monitors drawer (or Storage disk for a floppy-based system) into your 
Devs/Monitors drawer. Then you reboot the machine and run the Screen- 


Mode preferences program. 

You should now see three new modes: Multiscan: 640 x 240, Multiscan: 
Productivity and Multiscan: Productivity Laced. Select Multscan: Produc- 
tivity and click on Save. Your Amiga is now outputting a VGA-compliant 
signal. If you have been using a TV up till this moment, the TV screen will 
be unusable, and your VGA monitor will be displaying a crisp, flicker-free 
Workbench screen. 

That’s all very well for the Workbench screen, but what about applica- 
tions that open up their own screen? Well, for monitors that can sync down 
to 29 kHz (i.e. many SVGAs), you should use the DBL.PAL screen mode 
for Workbench and click on the Mode Promotion checkbox in the IControl 
preferences editor. Now all PAL screens will be automatically scan-doubled, 
and output at 29 kHz. However, if, like me, you are using a monitor that 
only does 31.4 kHz, you are left with a slight problem. 

Fortunately, there is a public domain program called ForceMonitor that 
lets you replace any screenmode with another. This means that we can 
replace all PAL and NTSC screens with VGA ones. The big advantage 
of ForceMonitor is that it will intelligently promote screens with differing 
vertical resolutions, i.e. a non-interlaced PAL screen will be promoted to 
640 x 240, while an interlaced one will be promoted to Productivity. 5o now 
I can enjoy a sharp, flicker-free screen for all Intuition applications. The 
only things that won't promote are most games and demos—you still need 
a TV or 15 kHz monitor for them. 


Computer Philosophy 


A computer, to print out a fact, 
Will divide, multiply, and subtract. 
But this output can be 
No more than debris, 
If the input was short of exact. 
— Gigo 
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